home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / xpath39.zip / README.XP < prev    next >
Text File  |  1991-10-17  |  17KB  |  465 lines
  1.  
  2.  
  3.  
  4.  
  5.         Apologies for the shareware pause that comes up every time you 
  6.         execute XPATH.  The screen displayed is there because XPATH.EXE gets
  7.         distributed to other bulliten boards without the accompaning
  8.         README.XP file that has the order form in it.  Thus, the shareware
  9.         screen provides a method for people to order the product.  The screen
  10.         does not appear in the registered version of the program.
  11.  
  12.  
  13.                              XPATH Version 3.7
  14.                              -----------------
  15.  
  16.          Have you ever tried to set your path longer than  127 characters? 
  17.          Without XPATH, or a similar product, it just can't be done.  The
  18.          reason is that you cannot type more than 128 characters at the
  19.          prompt.  Even if you create a BAT file where you can type more than
  20.          128 characters on a line, you cannot set your path past 127
  21.          characters because the command interpreter will not read past the
  22.          128th column of you BAT file.  
  23.  
  24.          This problem is solved when you use XPATH.  With XPATH, you create
  25.          a file that contains 1 line for each directory you want in your
  26.          path.  You then simply execute XPATH, specifying the file that
  27.          contains the directories you want in your path.
  28.  
  29.          For example, say you want your path to look like this:
  30.  
  31.          c:\;c:\dos;c:\util;c:\util\rexx20\pgms;c:\windows;c:\windows\excel
  32.  
  33.          You create an ASCII (text) file that looks like this:
  34.  
  35.          c:\
  36.          c:\dos
  37.          c:\util
  38.          c:\util\rexx20
  39.          c:\util\rexx20\pgms
  40.          c:\windows
  41.          c:\windows\excel
  42.  
  43.          Save the file giving any name you wish.  Let's say you name it
  44.          PATH.TXT.  You would then create your path by executing the XPATH
  45.          command as follows:
  46.  
  47.          XPATH PATH.TXT
  48.  
  49.          The above format assumes that PATH.TXT is in your current directory
  50.          and XPATH.EXE is in your current path or current directory.
  51.  
  52.          If the file containing the directories you want in your path is not
  53.          in your current directory when you execute XPATH, you can specify
  54.          where the file is in the following way:
  55.  
  56.          XPATH C:\DATA\PATH.TXT
  57.  
  58.          That is how you would do it if your path file is called PATH.TXT
  59.          and is in a sub-directory on C called DATA.
  60.  
  61.       -->Note: some versions of the shareware xpath is named XPATHSW.  In this 
  62.                case the command is XPATHSW rather than XPATH; or if you wish, you 
  63.                may rename XPATHSW.EXE to XPATH.EXE.
  64.      
  65.                        _____________________________________________________
  66.                        XPATH is a registered trandemark of XWARE Development
  67.          Page 1                                               copyright 1991
  68.  
  69.  
  70.   Extra Features   
  71.   -------------- 
  72.  
  73.         But wait, there's more.  We have just added 3 new features!  
  74.  
  75.         You can now add and deleted from your path on the fly.  Suppose you
  76.         want to add the directory C:\WING to your path right away.  Simply 
  77.         type: 
  78.  
  79.                 XPATH -A C:\WING
  80.  
  81.         That's all you have to do.  Xpath will add the new directory to the
  82.         end of your current path.  It does not modify your path data file
  83.         though, so the next time you reboot, the added path will not be there.
  84.  
  85.         Suppose you want to delete the directory C:\WINDOWS out of your path. 
  86.         Simply type:
  87.  
  88.                 XPATH -D C:\WINDOWS
  89.  
  90.         That's all you have to do.  The rest of your path remains intact, but
  91.         C:\WINDOWS is removed.
  92.  
  93.         The 3rd new feature added to xpath is the directory list feature. 
  94.         Simply type XPATH with no parameters, and all the directories in your
  95.         path are listed on separate lines.  You can use this feature to
  96.         create a file that can later be used as input to xpath in your
  97.         autoexec.bat file.  For example:
  98.  
  99.         Type:
  100.                 XPATH -L >PATH.TXT
  101.  
  102.         You will get a file that has a list of directories in your path.
  103.         This file will also contain the xpath logo (and shareware information
  104.         if you have not yet registered), so you will have to edit the file to
  105.         delete that stuff.  Remember to also delete the byte total at the end
  106.         of the file.  Then save the file and use it as input to XPATH in your 
  107.         autoexec.bat file as described on the previous page.
  108.  
  109.         IMPORTANT NOTE: If you have not registered your copy yet, a pause
  110.         comes up and you are required to press enter after the pause. 
  111.         When you use the above method to create an input file for Xpath, you
  112.         will not see the "press enter to continue" message", but you still
  113.         have to press enter.  If you have an unregistered version, wait 3
  114.         seconds after typing XPATH >PATH.TXT and then press enter.
  115.  
  116.         Starting with version 3.5, the total bytes in your path are reported
  117.         when you type XPATH with no parameters.  I have found that some app-
  118.         lications lock up when your path starts to get long.  The application 
  119.         that I had a problem with was BRIEF (a text editor).  When my path
  120.         reached about 265 bytes, BRIEF would lock up when I tried to invoke it.
  121.  
  122.      -> Type XPATH -? for help and expamples.
  123.  
  124.  
  125.                        _____________________________________________________
  126.                        XPATH is a registered trandemark of XWARE Development
  127.          Page 2                                               copyright 1991
  128.  
  129.  
  130.          Possible problems
  131.          -----------------
  132.  
  133.          One of the main reasons you would want to use xpath is because you
  134.          want a path longer than 127 characters.  So, after using XPATH, if
  135.          you type the PATH command to display your path, you may see that your
  136.          path is longer than 127 characters.  My path is 197 characters. When
  137.          I run the setup program for the text-editor I use (BRIEF), it tries
  138.          to insert d:\brief into my path.  At the time it does this, it is a
  139.          little confused because it sees my path is longer than 127
  140.          characters.  It issues a warning message that says my path is too
  141.          long, but no problems occur.
  142.  
  143.          Anytime you run an install program that puts a path command in your
  144.          autoexec.bat file, you will have to take that path command out and
  145.          put that path in your path file that you use when you execute XPATH.  
  146.  
  147.          Some programs that read your path could have a problem with a path
  148.          longer than 127 characters.  Some programs may stop searching the
  149.          path after the 127th character, or even blow up when they find that
  150.          your path is larger than 127 characters.  I've only encountered this
  151.          problem with BRIEF and a path greater than 165.
  152.  
  153.       -->When your path gets unusually large, the whole thing may not display
  154.          when you type the dos PATH or SET command.  The reason for this is that  
  155.          DOS doesn't expect your path to ever be longer than 127 bytes, so it gets
  156.          confused when it's longer, and it prints just part of the path.  Sometimes
  157.          it will print the whole thing even when it's greater than 127 bytes, but to
  158.          be sure you're seeing your whole path, type XPATH with no parameters when you
  159.          want to see your path.
  160.  
  161.          DOS 5.0
  162.  
  163.          After you have set your path with XPATH, using the DOS path command to 
  164.          look at your path will not work.  You will see only part of your path.
  165.          The same is true when you look at your path by typing SET.  To see your
  166.          path, type XPATH with no parameters.  Your path will list out -- each 
  167.          directory displaying on a new line.  
  168.  
  169.           -> Remember, the longer your path gets, the greater the possibility 
  170.              some applications will have of locking up.                    
  171.  
  172.              ONCE YOU HAVE CREATED A PATH > 127 CHARACTERS, DO NOT USE DOS'S
  173.